
See the english explonation in next pages...


== 
== UTILISATION DU PLUG-IN TROPHY 1.0
==


A quoi sert le plug-in ?

Le plug-in <TrophyPlugin> permet  une application tiers de lancer l'application <Trophy Mac> Il 
Ce plugin localise l'application sur le disque et gnre l'vnement de lancement de l'application  partir des paramtres passs. Ces paramtres au nombre de 4 sont passs au travers d'un fichier intitul <Plugin Data>. Ce fichier doit se trouver dans le mme rpertoire que le plug-in


Compatibilit :

Ce  plug-in est utilisable uniquement sous Macintosh. Il est compatible Mac OS 9.x et 10.x .


Installation :

Le plug-in peut tre install n'importe o sur le disque ; il doit seulement tre accessible depuis votre
application. 


Comment utiliser le plug-in ?

L'application <Trophy Mac> attend en paramtre, le nom et prnom du patient, la rfrence du 
praticien  et le chemin d'accs au rpertoire de sauvegarde des radios dentaires du patient. Le 
lancement de l'application se droule en deux tapes : 1/  construction d'un fichier avec les paramtres
 passer ; 2/ lancement du plug-in  partir d'un appel systme (qui dpend de votre langage de
programmation). Le fichier de paramtres doit imprativement s'intituler <Plugin Data> et se situer dans
le rpertoire du plug-in.


Format du fichier  <Plugin Data> :

Les paramtres doivent tre crits dans l'ordre suivant :

<prnom du patient>
<nom du patient>
<rfrence du praticien>
<chemin absolu du rpertoire du patient>

Ces paramtres doivent tre passs sous forme de chane de caractres de 255 caractres max. 
Le caractre retour chariot <\r> est utilis comme caractre sparateur pour extraire les informations.

Le chemin absolu du <rpertoire patient> doit tre pass sous la forme : <volume>:<rp. 1>: ... :<rp. n>:<nom du rp. patient>, le volume pouvant tre un disque partag sur le rseau. 

Echec au lancement :

Le lancement de l'application <Trophy Mac> peut chouer dans les cas suivants :

- l'application n'a pu tre localise sur votre disque,
- le fichier <Plugin Data> n'est pas prsent dans le rpertoire du plug-in,
- le fichier <Plugin Data> ne dispose pas des droits de lecture pour le plug-in,
- le fichier de paramtres est incomplet ou ne respecte pas le format attendu.

Attention, le plug-in ne retourne aucun code d'erreur dans la mesure ou le langage de programmation de l'application
qui le lance n'est pas connu  priori. Il appartient  l'application elle mme de vrifier le lancement de <Trophy Mac>.

-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------


==
== TROPHY 1.0 PLUG-IN USER GUIDE
==

Why a plug-in ?

The plug-in <TrophyPlugin> allows a software (which is not made by Trophy) to launch the imaging Trophy Mac software <Trophy Mac>. The plug-in finds the Trophy Mac imaging software on the local hard disk and creates the necessary event for the launching. Specific parameters are sent to the imaging software via a text file.

Compatibility :

This Plug-in can be used along with a Macintosh operating system : OS 9.x and OS X.x.

Installation :

The plug-in can be installed anywhere on the hard disk, it must only be accessible from the your software.

How to use the plug-in ?

<Trophy Mac> requires the parameters : Patient's last name and first name, doctor's references, path of the image directory of the patient.

The <Trophy Mac> launching is made in two steps :
	1/ creation of the text file containing all the parameters to be transmitted.
	2/ launching of the plug-in via a request from your software (according to your development language). The name of the text file must be <Plugin Data> and must be located into the same directory as the plug-in itself.

File <Plugin Data> format :

The following order must be strictly as follow :

<first name of the patient>
<last name of the patient>
<reference of the doctor>
<path of the patient's imaging directory>

Each parameter must be written in one line with a maximum of 255 characters.
The carriage return character <\r> must be place at the end of each line (each parameter)

The parameter <path of the patient's imaging directory> must be given completely as shown below, directories must be separated with <:> :

	Server HD :Trophy Data:John Smith

In this example, <Server HD> can be a hard disk shared out on the network.

Failures during the launching :

The launching of <Trophy Mac> can fail in the following case 

	- The Trophy Mac imaging software could not be found on the local hard disk
	- The file <Plugin Data> could not be found into the plug-in's directory
	- The plug-in has is not authorized to read the file <Plugin Data> 
 	- The file <Plugin Data> is not complete or does not meet the required format

